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Preface 

TINY BASIC provides the most fundamental of those functions normally 
attributed to the high-level programming language called BASIC. It is specifically 
designed for a microcomputer with minimal memory. The TINY BASIC interpreter 
program requires only 2K bytes of storage. Thus, an Evaluation Kit with 4K of 
RAM can accomodate modest (about 100 statements in length) TINY BASIC programs. 

TINY BASIC is perhaps the best language for the beginning microcomputer 
progr 2 anmer. It is easily learned, and elementary application programs may be 
developed quickly. For the more experienced programmer ^ TINY forms the kernel 
of a system whose facilities may be extended indefinitely by the addition of 
machine- language subroutines (limited only by the amount of memory which is 
available) . 

TINY packs a significant amount of processing capability within 2K bytes. 

For example, it includes its own line editor, and it provides a rich assortment 
of error messages to the user. However, clearly one cannot expect certain 
features which are normally available only in 8K systems. For example, TINY 
does not do floating-point arithmetic. (Its numeric capability is limited to 
integers in the range -32768 to +32767.) It cannot directly handle arrays or 
alphanumeric strings. (On the other hand, each of these (and other) advanced 
facilities may be added via a machine- language extension) . In addition, one 
must recognize that economies in memory space used were achieved at the expense 
of processing speed. 

Generally, then, TINY BASIC may be considered as a good "budget*' high-level 
language for a user with a comparable microcomputer setup. Although TINY is 
quite slow and is of limited capability, it can act as the nucleus of a system 
whose sophistication may be indefinitely extended. 
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INTRODUCTION 


We assvune that you are already familiar with section III of the 
Evaluation Kit Manual which explains the functions available 

from the resident utility program UT4. UT4 permanently resides in 
memory locations 8000-81FF. After it is given control (via the RESET, 

RUN U, CR or LF sequence), it types its prompt character, an asterisk, 
indicating that it is awaiting your input. Each of your input lines 
(terminated with a CR) is interpreted and executed by UT4. After dis- 
posing of your input command , UT4 indicates that it is ready for new . 
input by typing another * prompt. 

One importzmt function of UT4 is to permit you to load an arbitrary 
sequence of hexadecimal digits (a machine language program) into an 
arbitrary area in memory and then to invoke this program (transfer 
control to it; run it) via the appropriate $P command. When your 
program completec its computation, it may relinquish control back to 
UT4 by executing a C08039 instruction (a long branch to the location 
labeled START on p.3-16), provided all registers used by UT4 have the 
values they had when UT4 exited .t Under these conditions, a user program 
halt (or exit) would be signified by a new * UT4 prompt. 

COSMAC 2K TINY BASIC is a program which must be loaded into the 
lowest 2K bytes of memory (locations 0000-07FF) . A hexadecimal listing 
of the program and loading instructions for it appear in Appendix A. 

After TINY BASIC is made resident, control is transferred to it using 
the proper $P UT4 command (see Appendix A). Once it receives control, 
TINY BASIC delivers its prompt character, a colon, and awaits your input. 
Each time after it has properly disposed of an input line (terminated 
with a carriage return - CR) , TINY BASIC again types its : prompt. 

t In particular, P should be 5. 
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If an input line does not begin with a number, TINY BASIC immediately 
interprets it and executes it. (The line is called a statement . ) If the 
line begins with a number (normally followed by a statement), then TINY BASIC 
merely stores it, in the proper position, in an area of memory where the 
user program (a sequence of statements ordered by statement number) is 
assEmbled. If the statement number is the same as one already existing in 
this area, then the new statement replaces the old one. Thus, you load a 
TINY BASIC program by entering a sequence of statements (one per line), each 
preceded by a unique statement number. The program must have at least one 
END statement in it. 

After your program has been loaded, you can run it by typing a RUN 
command (equivalent to the $P command to UT4) . TINY BASIC will then interpret 
and execute your program's stalanents, in order, following the rules discussed 
in subsequent sections. When an END statement is encountered during execution, 
control will be passed back to TINY BASIC's "enter** mode, and another : prompt 
will be issued. 

Note that TINY BASIC assembles statements which begin with numbers 
into the program area in memory without any further analysis. Errors are 
detected only when execution is attempted. If an entered line consists only 
of a line number, it is considered a deletion . The previously inserted 
statement with the same line number is erased. Note also that 0 is not 
a valid line number. Blanks within a line have no significance to TINY. 

All spaces, until the first non-^numeric character, are totally ignored. 

After that, however, blanks are preserved in the memory copy of the 
statement (i.e., each blank character occupies one byte). 

NUMBERS 


A number is any sequence of decimal digits optionally preceded by 
a sign. If no sign is present, the number is assumed positive. Since 
TINY BASIC stores all numbers internally as 16-bit signed integers, 
positive values may run from 0 to 32767 (2^®-l) and negative values may 
run from -1 to -32768 (-2^®). 


10-3 



C09MAC TINY BASIC 


CDP18S020 Evaluation Kit 


VARIABLES 

A veuriable is any single capital letter (A-Z) . Each possible variable is 
assigned a unique two-byte location in memory. The value of the variable is 
the contents of that location — i.e., a number in the range -32768 to +32767. 

EXPRESSIONS 


An expression is a combination of one or more numbers or vauriables, joined 
by operators and possibly grouped by parenthesis pairs. The permissible 
operators are; 

+ addition 
- subtraction 
* multiplication 
/ division 

Whenever TINY BASIC encounters an expression within a statement (during its 
execution) it evaluates the expression — combining the numbers and the values 
of the variables, using the indicated operations. The exact disposition of the 
final computed value depends on the type of statement. This is discussed fxirther 
later. 

Internal sub-expressions within parentheses are evaluated first. Usually 
parentheses make clear the order in which operations are to be performed. However, 
if there is ambiguity because parentheses are absent, TINY gives precedence to 
multiplication and division over addition and subtraction. Thus, in evaluating 

B-14*C 

the multiplication is performed first. In cases involving two operators of equal 
precedence, evaluation would proceed from left to right. An expression may be 
optionally preceded by a sign. 
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Note that during the evaluation of an expression, all intermediate values, 
and the final value, are truncated — using the lowest 16 bits of the results. 
That is, expressions are evaluated modulo 2^®. TINY BASIC makes no attempt to 
discover arithmetic overflow conditions, except that an attempt to divide by 
zero results in an error stop. 

The following <u:e some examples of valid expressions: 

(Note that a single variable or number is also an expression.) 

A 

123 

1+2-3 

B-14*C 

(A+B)/(C+D) 

-128/ (-32768+ (1*1)) 

((((Q)))) 

The following are some examples of expressions which have the same value: 

-4096 

15*4096 

32768/8 

30720+30720 

because any number in the range 32768 to 65535 (2^® to 2^®-l) has a sign bit of 
Kmeiking it negative) , so that it is actually treated by TINY BASIC as if 65536 
(2^®) were si:d>tracted from it. 

THE RND FUNCTION 

TINY BASIC includes the ability to generate a positive pseudo-random number 
in a specified range. Whenever it encounters the form 
RND (expression 1, expression 2) 

during execution of a statement , TINY generates a random number in the range from 
the value of expression 1 to the value of expression 2, inclusive. The resulting 
number may be used as would any other number. In particular, the above form may 
itself be used within another expression . If the arguments are invalid, an error 
stop may result. 
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THE RND FUNCTION (cont'd) 

RND (1,100) 

RND (A,B) 

are valid RND functions (assuming 0<A<B) . 

STATEMENT TYPES 

A Statement normally begins with a keyword , such as PRINT or GOTO , 
Indicating the type of statement . The interpretation of the remainder of 
the statement depends on this keyword. In some cases, a short form of the 
key ward is also acceptable — for example, PR instead of PRINT. 


REM STATEMENT 


Following the keyword REM (for remark or comment) any sequence of 
characters may appeaur. This statement is ignored by TINY BASIC. It is 
used to permit you to intersperse arbitrary comments or remarks within 
your program. 

END STATEMENT 

END must be the last statement executed in a program. It is used to 
halt execution and return to TINY BASIC’s "enter" mode. There may be as many 
END statements in a program as needed. 

LET STATEMENT 

This statement has the form 

LET variable = expression 

Alternatively, the keyword LET may be omitted entirely. Execution of this 
statement assigns the value of the expression to the variable. The following 
are valid LET statements: 

LET A » B+C 
1 = 1+1 
J - 0 

LET Q « RND (5,33) 


10-6 



CDP18S020 Evaluation Kit 


COSMAC TINY BASIC 


IF STATEMENT 

This statement has the form 

IF ej^ressionl relation expression2 THEN statement 
The keyvrord THEN may be omitted entirely. Execution of this statement 
evaluates the two expressions and compares them according to the relation 
specified. If the condition specified is TRUE, then the associated state- 
ment is executed. Otherwise, the associated statement is skipped. The 
permissible relational operators are as follows; 

= equal 

< less than 

> greater than 

<=‘ less them or equal (not greater) 

>= greater than or equal (not less) 

<> or >< not equal (greater than or less than) 

The associated statement may be any other valid TINY BASIC statement including, 
in particular, another IF statement. The following are some valid IF statements; 
IF I>25 THEN END 
IF A>B IF B>C 1=1+1 

(The last statement increments I only if B is between C and A.) 

TRANSFERS OF CONTROL 

TINY BASIC normally executes statements in a program in statement number 
order. The following statements may be used to alter this flow; 

(a) GOTO expression 

The subsequent statement executed is the one whose line number equals the 
value of the expression. Note that this permits you to compute the line 
number of the next statement on the basis of program parameters during execution. 
The following are some valid GOTO statements; 

GOTO 100 

GO TO 200 + 1*10 
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(b) GOSUB expression 

This statement executes exactly as does the GOTO statement > except 
that in addition TINY records (remembers) the statement number of the following 
statement (the one which would have been executed next, had the branch not 
taken place) . 

(c) RETURN 

This statement (which also has the short form RET) executes by transferring 
control back to the statement whose number was last recorded as the result of the 
execution of a GOSUB. This last-recorded statement number is also forgotten. 

SUBROUTINE NESTING 

A subroutine is a sub-program which is normally evoked in two or more 
places within a main program. Rather than duplicate the statements of the 
sub-program in several places, it appears only once. It is written so that it 
exits with a RETURN statement. It is evoked at any point in a program by a 
GOSUB statement which transfers control to it. 

Whenever one subroutine calls another subroutine (termed subroutine "nesting”), 
an additional "return-statement-number" is recorded. These are stored in order , 
so that every RETURN jumps back to the statement following the GOSUB which 
called it . Subroutines may be nested to any depth, limited only by the 
amount of user program memory remaining. 

PRINT STATEMENT 

This statement has the form 
PRINT printlist 

where printlist is a succession of one or more items to be printed separated 

by either commas or semicolons. The acceptable short form for PRINT is PR. 

Each print item may be either an expression or a character string enclosed in 

quotes . In the first case the value of the expression is typed. In the 

second case the character string is printed verbatim. No spaces are generated 
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between the printouts of items separated by semicolons in the PRINT statement. 

On the other hand, the printout of an item, preceded by a comma in the PRINT 
statement, begins at the next "tab setting”. Tabs are automatically set every 
eight character spaces. Thus, 

PRINT 1,2,3 prints as 
1 2 3 

while PRINT 1; 2; 3 prints as 
123 

Commas and semicolons, character strings and expressions may be mixed in one 
PRINT statement in any manner. 

Normally, the execution of a PRINT statement terminates with the generation 
of a carriage return and line feed to begin a new line. However, if the PRINT 
statement ends with a comma or semicolon, then the CR-LF sequence is suppressed, 
permitting subsequent PRINT statements to output on the same line or permitting 
an input message (see INPUT, next) to appear on the same line as previous output. 

The following are valid PRINT statement examples: 

PRINT "A=";A,"B+C=”;B+C 

PR (generates a blank line) 

PRI (prints the value of variable I) 

PRINT l,",",Q^P;",",R/42; 

INPUT STATEMENT 

This statement has the form 
INPUT inputlist 

where inputlist is a succession of one or more variables separated by commas. 

The acceptable short form for INPUT is IN. Normally, execution of this 
statement begins with the typing of a question mark prompt indicating that 
TINY is expecting the user to type in data. The user should respond by typing 
in a line of one or more expressions separated by commas and terminated with a 
carriage return. Each input expression is evaluated and assigned to its 
associated variable in the INPUT statement. 
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If the number of requested veurlables In the Inputllst la not satisfied 
by the number of expressions In the user's Input line, a new ? pronpt will be Issued 
asking for more input Information. If the number of expressions In the user's 
input line Is greater than the number of requested variables, then those Input 
e3q>ressions not requestctd are saved Internally and used to satisfy subsequent 
INPUT requests. Thus, before a ? prompt is issued during execution of an 
INPUT instruction, TINY first checks to see if any saved expressions exist. 

If so, then these eu:e used first - to satisfy some or all of the variables 
requesting values. Only when no saved data exists Is the ? prompt issued. The 
user is cautioned to use the latter property of the INPUT statement with care. 

Exanple: Suppose statement INPUT X,Y,Z is executed, and the user responds 
by typing A,C,B. The results are the same as if X«A, Y«C and Z«B had been 
executed. Note that commas are required in the user's input line only to avoid 
ambiguity. If he had entered ACB, the same results would have occurred. On 
the other hand, an input line of +1 -3 -fB 0 in response to INPUT A,B,C,D will 
result in A being given the value 58 2 md a new ? pronpt Issued for values for 
B,C and D. 

SYSTEM CONTROL STATEMENTS 


The statements listed below are normally not Included as part of a program. 
That is, they are normally entered without line numbers: 

(a) NEW 

Execution of this statement clears the prograun area in memory. It is used 
before entering a new program. 

(b) RUN 

Begin program execution at the first (lowest) line nvimber. Note: If RUN 
is followed by a comma followed by a sequence of* one or more expressions 
(separated with ccxnmas) , then the expression list is treated as an initial 
input line — which will be scanned first whenever INPUT statements are 
executed. (See discussion of INPUT statement.) 

(c) LIST 

LIST expression 

LIST expression, expression 10-10 
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SYSTEM CONTROL STATEMENTS (cont'd) 


(c) (cont'd) 

The LIST statement causes part or all of a stored user program to be 
printed. If no parameters are given, the whole program is listed. A 
single expression parameter is evaluated to a line number. If the line 
exists, it is printed. If both parameters are given, all lines with 
numbers in the range specified cure printed. 
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SUMMARY OF COSMAC TINY BASIC REPERTOIRE 


The following should serve as your short form guide to the facilities offered 
by TINY BASIC. Characters enclosed in brackets [ ] are optional amd may be omitted. 

FORM OF STATEMENT BRIEF EXPLANATION OF EXECUTION 

REM 2 my comment Ignored. 


END 


Halt execution amd return to "enter" mode. 


Ilet] variable = expression 
IF expr rel expr [THEN] statement 

GOTO expression 


GOSUB expression 
EET[URN] 


Assign the value of the expression to the vari- 
able 

If the relation between the values of the 
expressions is TRUE, execute the statement. 
Otherwise, skip it. 

Junp to the statement whose number is the 
expression's value. 

Save the statement number of the next statement 
in sequence. Then execute a GOTO. 

Juip to the last saved statement number 
(see GOSUB) and "unsave" this number. 


PR[INT] printlist Type the items in the printlist. Type values 

of expressions. Type quoted strings verbatim. 
Horizontal TAB on comma. 

IN [put] inputlist Read amd evaluate expressions from the keyboard 

and assign them in order to the variables 
specified in the inputlist. 


NEW Cleaur the program area. 

RUN I , expression sequence] Start execution at first statement. (Save 

the expression sequence to satisfy 
subsequent INPUT'S.) 


LIST [ expression] [, expression] Print entire program, or one selected line, 

or a ramge of lines. 

where: 

nvunber = -32768 to +32767; variable = single capital letter. 

expression = one or more nimibers or variadxles (possibly grouped by parentheses) 
joined by operators +,-,*, or /. 

relations are =,>,<,<»,>»,<>, or >< . 

printlist - one or more expressions or quoted strings separated by commas or semicolons. 

inputlist B one or more variables separated by commas. 

expression sequence » one or more expressions separated by commas. 

NOTE: The RND(exprl,expr2) function generates a positive remdom n\imber in the range 
between the values of the expressions. This function may be used anywhere in 
olace of a number. in_i 9 
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IMMEDIATE EXECUTION VS. PROGRAM MODE 

One io^rtant use of the immediate execution mode (entering a statement 
without a line number) is to permit line-at-a-time testing. LET, IF and PRINT 
can be demonstrated this way. Due to the way TINY BASIC buffers its input lines, 
the INPUT statement cannot be directly executed for more than one variable at 
a time, and if the following statement is typed in without a line number, 

INPUT A,B,C 

the value of B will be copied to A, and only one value (for C) will be requested 
from the console/terminal. Similarly, the statement, 

INPUT X,l,y,2,Z,3 

will execute directly (loading X,y, and Z with the values 1,2,3), requesting no input, 
but with a line number, in a progreun, this statement will produce am error stop after 
requesting one value. 

Clearly there is no point to executing REM or END in the immediate mode. 
Furthermore, GOSUB and RETURN are normally meant for the program mode. On the 
other hand, an immediate GOTO has the same effect as if RUN were typed, but execution 
may begin at other than the program's first statement. 

Similarly, the stored program should not contain a NEW statement (self destructl), 
and a stored RUN statement will be equivalent to a GOTO to the first statement. 

On the other hand, a LIST statement may be included as part of a program and used 
for printing large text strings, such as instructions to the operator. 
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PROGRAMMING EXAMPLES 

The following two simple programs are designed to give you exan^les of 
TINY BASIC in action. The first uses most of the statements in TINY's repertoire. 
The second demonstrates particularly the use of subroutines. REMarks are omitted 
from the listings to keep them short. Instead, each progr 2 un is accompanied by 
a detailed explanation of its functioning. (It should be emphasized that 
omission of comments is generally bad documentation practice, but it suits our 
present objectives.) Each program can be entered in a few minutes. It is 
recommended that you run both of them to gain e:q>erlence with the system. 

I* Arithmetic Drill Program 

This program generates a r 2 mdom sequence of curithmetic problems. After the 
program prints the problem, you respond with your solution. The program tells 
you whether your answer was correct or not (providing the right answer in the 
latter case) emd then proceeds to generate a new problem, and so on. 

Stepping through the program listed below: first, three random numbers are 
generated. The value of F (1 to 4) will be used to decide whether this will be 
an add, subtract, multiply or divide problem. The range of possible values for 
the arguments A and B was chosen to prevent the possiblity of overflow under two 
conditions: First, 181*181 is still less than 32767. Second, division by zero 
is prevented. Because TINY BASIC discards division remainders, the fourth state- 
ment is included to keep the division problems interesting. It says: If this 
is a division problem where the quotient would ordinarily come out as zero (true 
for many of the A,B combinations that might be generated) , arbitrarily increase the 
size of the dividend (to a maucimum of 18100 in this case) to make the problem 
non- trivial. Statement 50 begins the presentation of the problem to the user by 
printing an encouraging message followed by the value of the first argument. 

Notice that the final semicolon keeps the printer on the same line without advancing 
the carriage further. 

Statement 60 does a four-way branch based on the value of F (the arithmetic 
function selected) . Thus, control passes next to one of the following statement 
numbers: 70, 100, 130 or 160. Each of these statements begins a short sequence 

which prints the sign for the arithmetic operation and then computes the proper 
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I. Arithmetic Drill Program (cont'd) 

tixnctlon, placing the result in C. (Notice the final semicolons again, 
in the PRINT statements.) No matter which path is taken, control passes next to 
statement 180, which prints the second argument value followed by an ■ sign. 

The presentation of the problem to the user is now con^lete , amd the INPUT 
statement at 190 delivers a ? pron^t on the s£une print line amd reads the 
user's answer into D. Statement 200 congratulates the user on a correct answer, 
while 210 points out that his answer was incorrect and provides him with the 
proper result. The commas at the end of both PRINT statements here again Inhibit 
a new line from starting, but they space over to the next tab setting, where a new 
problem is posed as a result of the loop (at 220) back to the top. 


10 1S1> 

20 E=;RriIi«::i» 1S1> 

30 F=RNri<l<.4> 

40 IF F=4 IF Fl=fi^l00 

50 PRINT "TRY THIS ONE: "JR; 

60 60 TO 4 0+F4-30 
70 PRINT " + 

80 C=fl+B 
90 60 TO ISO 
100 PRINT 
110 C=fl-B 
120 60 TO ISO 
130 PRINT 
140 C:=fl^E 
150 60 TO ISO 
160 PRINT". 

170 C=R.-B 
180 PRINT b;"="; 

190 INPUT n 

200 IF Ii=C PRINT "RI6HT!"!. 

210 IF D <> C PR I NT " I.IR0N6 . CORRECT RNSWER IS " ; C » 
220 60 TO 10 


Notice that an END statement is not present here — contrary to earlier advice. 
The nature of this program is such that TINY will never go past the last statement. 
The program as written loops endlessly, and only under these conditions is the 
omission of an END permissible. 


Running this program should give you some practice in learning how TINY divides 
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Geometric Print Pattern Program 

This progreun is designed to print three identical , trapezoidal patterns 
across the page, each filled with repeated imprints of the Scune numeric digit. 

The user can specify which digit is to fill each trapezoid and, for all three, 
the number of characters across its top, the slope of its sides (positive or 
negative) and its height. He can also specify the spacing between the patterns 
on the page. 

Since the printer prints line-by-line, the program prints the pattern in 
a scanning mode. Every line consists of a sequence of three identical segments, 
and each segment contains D spaces followed by E identical digits followed by 
O spaces again. The values of D and E vary from line to line. For each new line, 

D is decremented by a value I (positive or negative) and E is incremented 
by 2*1 (to keep the pattern symmetrical) . 

To analyze the program listed below, let us begin by identifying its 
subroutines. Reading from the bottom up, the subroutine from 250 to 280 prints 
the digit N, M times across (notice the semicolon) . Similarly, the subroutine 
from 210 to 240 prints a sequence of M spaces. Finally, the subroutine from 
140 to 200 prints D spaces followed by E digits (all N) followed again by D spaces. 
Notice that this subroutine calls the other two. 

The main part of the program runs from 10 to 130. First, the program 
initializes a counter J for the number of lines which have been printed. Then 
it reads (from the user) initial values for A to E, I and L (the total number of 
lines to be printed). A,B and C should be single digits. D,E and L must be > 0. 
Each of the three sequences 30-40, 50-60, and 70-80 prints one segment of a line 
using the digit specified by the user. 85 starts a new line. 90 and 100 advance 
D and E as explained earlier, and 110-120 decide whether or not a sufficient number 
of lines have yet been printed. If not, a new line is started. 
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GEOMETRIC PRINT PATTERN PROGRAM 


10 J=0 

20 INPUT fli.Bi.C-.Dj.E!! InL 
30 N=fl 

40 GOSUB 140 
50 N=B 

GO GOSUB 140 
70 N=C 

80 GOSUB 140 
85 PRINT 
80 ri=D-I 
100 £=£+£♦! 

110 J=J+1 

120 IF JOL GO TO 30 

130 END 

140 M=D 

150 GOSUB 210 

IGO M=E 

170 GOSUB £50 

180 M=D 

190 GOSUB £10 

200 RETURN 

210 PRINT " 

2£0 M=M-1 

230 IF M>0 GOTO £10 
240 RETURN 
250 PRINT N; 

2G0 M=M-1 

270 IF r-1>0 GOTO £50 
£80 RETURN 


For this program to run properly the values of D and E should not become 
too small. Nor should they be so large as to requ Ire excessive line length. 
The Inital values should obey the following relations: 3 (E+2D) < maximum line 
width; If I<0, E>2ll|(L-l); If I>0, D>I (L-l) . 
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THE USR FUNCTION 

TINY BASIC includes an Important feature to permit you to extend its 
facilities via machine language subroutines. To use this feature, you must 
be fauniliar with many of the intricate details associated with machine language 
programming. Not only must you know the instruction set for the CPU (See MPM-201, 
User Manual for the CDP1802 Microprocessor) , but you must also be aware of 
which CPU and memory registers are reserved for TINY, which are freely available 
for your use eind which ceux act as eui interface between your machine- language 
program and your TINY BASIC program. We assume here that you are familiar with 
the manual cited above amd that you have some introductory machine language 
programming experience. 

The form of the USR construct within a TINY BASIC statement is as follows : 

USR (ejgjression I , expression] I , expression ]) 

where the brackets indicate that either or both of the latter two expressions may 
be omitted. On encountering this form, TINY evaluates the first expression and 
transfers control to that address . (Remember that a desired hex address must be 
converted into its equivalent decimal expression value, 2 uid that addresses in the 
upper half of memory have negative equivalent decimal values.) If a second ex- 
pression is included, it is evaluated and the resulting value is passed to the 
called program as the contents of CPU register 8. If a third expression is 
included, its value is passed in register A (with D also holding RA.O) . The 
subroutine receives control with P*3 2 ind X»2. 

Your called program must return with a SEP 5 (D5) instruction. When it 
returns, its 16-bit function value is the final contents of RA.l and D (lower 8 
bits in D) just before the SEP 5 was executed. This is why USR is called a 
function . Whenever it is called, it returns a result - a number. Thus, the 
USR form cam appear anywhere in a TINY BASIC statement where a number can 
normally appear. (Recall our previous discussion of the RND function. Exactly 
the same idea applies here.) 


10-18 



COSMAC TINY BASIC 


CDP18S020 Evaluation Kit 


Thus, in addition to performing some machine- language function (for 
example, moving a block of data) , your USR program will always return a value 
or result in RA.l and D. In many cases, this is desircdsle — for example, when 
your stibroutine is given two arguments X and Y (in R8 amd RA) and returns a 
number which is, say, the larger of the two. In other cases, however, your 
USR program will not need to return a value. In that case the value returned 
must be ignored in the TINY BASIC prograun which called it. There are several 
ways to do this. For example, if 

+0*USR( ..) 

were included in an expression, then the USR fxinction would be executed but the 
returned value would be ignored. 

For your convenience, TINY itself includes four built-in subroutines which 
you may want to make use of via the USR mechanism. They are as follows; 

(1) USR(20,N) 

Returns the decimal value of the byte at memory location N (decimal), where N 
is the value of the second ej^ression. (Note that this machine language routine 
begins at location 14 hex. ) 

(2) USR(24,N,M) 

Stores the value of the third expression, M (mod 256) into the byte at location N 
(decimal) , the value of the second expression. Also returns the value M as the 
function's "value". 

Excunples ; PRINT USR (20, 3072) prints the decimal contents of memory location OCOO 
A=USR(24,3072,254) loads memory location OCOO with FE and also loads 
the"returned value", 254, into A. 

(3) USR(6) 

Reads one ASCII character ■ from the keyboard and returns its decimal equivalent 
(including parity bit if any) . 
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(4) USR(9,0,C) 

Prints the ASCII character whose code is the right half of the (hex) value 
of expression C. (Note: The second expression, in this case 0, is ignored. 

The character to be typed must start out in a D register. Hence, the above format. 

The third expression is passed in RA with its lower half also in D.) This 

routine happens to return a "value” 251 in all cases — which would normally be ignored, 

as explained earlier. 

Examples : PRINT USR(6) will read a character and print its decimal equivalent. 

On the printer you would see, for example, A65 
for a zero parity bit (where A was typed by you) . 
A=A+0*USR(9,0,66) will print the character B and ignore the 

returned result (251). 


Register Usage and An Example USR Routine : 

When you write your own USR routine, you must be careful not to modify 
the contents of those registers which are used by TINY BASIC. These include 
CPU registers arid memory registers. Appendix B lists how the CPU registers are 
used by TINY. Machine language subroutines have the free use of 

R0,R1,R8,RA,RD and RF. 

In addition, R2 is pointing at a free byte on the control stack. 


Clearly, the memory areas used by TINY should also not be modified, except 
with care. TINY uses most of the first page of the available RAM (beginning 
at 0800) for its own storage. A table of the allocation of this space is given 
in Appendix C. You probably will not want to bother with any part of this area 
except for that which includes the A to Z variable cells. These are located 
at 0882 to 08B5. Note also that, by reducing the address value stored in 0822, 
you can make space for your added program and data areas in upper memory. 
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Appendix D lists some key locations at the beginning of the TINY BASIC 
progreUD itself. (Notice locations 6, 9, 14 and 18 which correspond to the entry 
points for the built-in subroutines discussed earlier.) TINY BASIC was written 
as a pure procedure (capable of execution out of BOM) — not modified in any way 
as it runs. This area should not be altered except, conceivably, for modifications 
to the special character codes beginning at location F. This is discussed further 
later in this manual. 

Consider now an example of a USB added routine. Assisne we wish to add a logical 
AND operation to TINY's repertoire. The machine language routine given below will 
do the job, given that the two arguments cure passed in B8 emd BA, emd that the 
computed result must be passed back in BA.l and D. 


98 

GHI 

R8 

Given two 16-bit arguments , 

this routine confutes the 

16-bit 

52 

STR 

R2 

AND of these and returns that result. Note the use of 

the 

9A 

GHI 

RA 

spare byte pointed to by R2 

and the assumption that X-2 

: on entry 

F2 

AND 


Notice also the SEP5 exit. 

This routine can be stored 

in 

BA 

PHI 

RA 

any available memory aurea. 



88 

GLO 

R8 




52 

STR 

R2 




8A 

GLO 

RA 




F2 

AND 





D5 

SEP 

R5 





Assuming the above program is stored at location (KTOO, then if L=3072, the 
statement T=USR(L,R,£) will assign to T the 16-bit AND of the values of variables 
R £uid S. 
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ERROR MESSAGES AND PROGRAM DEBDGGING 

Error Messages ; 

Whenever TINY BASIC detects an error in a statement, it generates an 
error message consisting of an exclamation point followed by a decimal error 
number. A listing of error nvimbers and their corresponding meanings is given 
In Appendix E. If the error is detected during program execution, the error 
code is followed by the word AT followed by the offending statementVs number. 

Almost all of the errors detected by TINY are syntax errors. TINY was 
in the process of interpreting a statement and fo\ind it imacceptadble for some 
reason. Only two of the errors in the error list are detected during execution of 
a statement (i.e., after its syntax has been accepted). These are errors 141 and 
243. 

Any other error number not listed in the table signifies a memory "full" 
condition — probably due to too mauiy nested GOSUB's or an excessively complex 
e3q>ression. 

Program Debugging ; 

Most program execution errors are due to either incorrect flow or improper 
modification of variable values. To find an error of the first kind, you must 
determine whether your prograun is sequencing properly • — whether certain sections 
of code are indeed executed when expected. Often, the insertion of dvunmy PRINT 
statements within suspected code sections will reveal whether the flow within the 
program is proper. 

The second type of error is most easily detected by inserting dummy program 
stops at key point. This procedure is also useful for diagnosing incorrect flow. 

A dummy stop is an inserted END, or some other inserted statement which is intent- 
ionally erroneous to cause an error stop. Once the stop occurs, you may examine 
the values of key variables (using the immediate execution mode - e.g. , PRINT A,B,C) 
to see if they indeed have the expected behavior. In some cases, variedjle values 
may be corrected, in the immediate mode, while the program is still stopped. In 

this case, and in the case where the program behavior is proper so far, you will 
want to resume the program at the point where it last stopped. An iiranediate or 
direct GOTO, using the statement number after the stop, will permit the program 
to proceed as if it had not been interrupted. 10-22 
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APPENDIX A 

LOADING AND STARTING TINY BASIC 

The hexadecimal listing given below is the TINY BASIC object progr5un 
(listed in UT4 semicolon format). Initially, you will have to load this file 
into memory by hcmd from the keyboard and then verify that it is a faithful 
copy. While this process is time consviming, it needs to be done only once. 

After memory is loaded, the contents of the first 2K bytes should be properly 
recorded on your peripheral file storage medium. Section III of your Evaluation 
Kit Manual contains instructions for recording a file from memory 

(using UT4's?M command) onto a Teletype's paper tape or a TI terminal's magnetic 
tape cassette. If your terminal is different from either of these, you must develop 
equivalent procedures to those described in the manual. Once you have correctly 
recorded a copy of TINY BASIC on paper tape or tape cassette, it should be easily 
reloadable by preceding the tape read with a IM from the keyboard. This is 
discussed in the Evaluation Kit Mamual. 

Once TINY BASIC has been loaded, it may be started at one of two locations: 

$P1 is the normal "cold" start. TINY BASIC initializes itself (sizes memory; 
copies a control block from OOOF-OOIB to 0813-081F; and marks the user progrcim 
space empty) and then delivers the : prompt. 

$P3 is the "warm" start, which skips the initialization procedure and 
preserves the state of RAM. It is used as a restart, when there is already 
a useful program resident in RAM or when certain control parameters have been 
modified so that they are different from those which were first initialized. If, 
after a "warm" start, you wish to enter a new program, type the NEW command. 
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0000 0130 BOCO OOEB C006 
0010 1883 8020 30SS 3020 
0020 4838 97Bfl 48D5 C006 
0030 83R6 93B6 46B3 46R3 
0040 86ft3 1242 B602 fl69F 
0050 4DED 304fl 0198 OlfiO 
0060 0481 0249 OOED 044E 
0070 04Rfl 01D3 01D3 02C5 
0080 053C 01D3 0429 036C 
0090 04 OE 0460 046D 0581 
OOfiO 01D3 01D3 01C9 01C5 
OOBO F8B3 fi3F8 00B3 D3Bfi 
OOCO BDFS OOFID ODBF E212 
OODO 9FF3 FCFF 8F52 3BC6 
OOEO 9273 2fl2fl 0873 8DFB 
OOFO F2fl3 F800 B3D3 B4B5 
0100 4Bft7 331 FI D720 BB4D 
0110 F4BF D724 9F73 9B7C 
0120 2682 7392 73D4 02CC 
0130 3033 4BFD D733 85FE 
0140 9373 97B6 4652 46fl6 
0150 FftlF 325C 5289 F473 
0160 F6F6 F6Ffi FEFC 54fi6 
0170 8633 7889 7399 73D4 
0180 2D74 B930 2IiFD 0752 
0190 Oli52 065D 0256 302D 
0180 96i:;2 027F B986 8930 
01 BO 10C7 FD09 0BD5 D401 

01 CO 30C9 D401 C5D4 01C9 
OHIO 2D4D 88II5 D401 88FB 
01 EO FF41 3B80 FF18 3380 
01 FO D401 883B 8097 B888 
0200 B8F8 088F EDID 88F4 
0210 0598 5D1D 8873 D401 
0220 B88B 88D4 0188 1B52 
0230 98BB 588B COOl 80Ii7 
0240 D549 3059 49B8 4930 
0250 C5D4 0254 88D4 0259 
0260 01F5 5D8D 025D Ii5D4 
0270 FB2F 3266 FB22 D402 
0280 18E8 11402 CCF8 21D4 
0290 2D77 B8D4 0315 9832 
0280 C5D7 28B8 4D88 D403 
02B0 D5D7 1897 5DIi7 26B2 
02C0 2083 11402 F249 FCSO 
02D0 7397 7373 08117 lEFE 
02E0 0009 D718 88FE 32EF 
02F0 F888 FF80 BFII7 1B2D 
0300 COOO 09D7 1EF8 07FIi 
0310 02F4 2830 08D4 0254 
0320 F32II D402 F497 73B8 
0330 E388 F6r9 3073 lIi4D 
0340 C201 C2D4 02F4 303E 
0350 8B52 FOFF 8033 5EIi7 
0360 B80D 888B 739B 5D98 
0370 FB80 7388 73D4 01C9 
0380 1298 FB80 7752 3B92 
0390 F638 8FF6 C7C4 19115 
0380 88F4 7398 745D D5Ii4 
03BO 880D FE5D 2D0D 7E5D 
03C0 F473 9874 5D2F SFID 
03DO 88F1 C202 7F0D F373 
03EO 1D97 C;897 7388 B8F8 
03F0 773B F6B8 0288 IDID 


6FC0 0676 CO 06 665F; 
5805 0681 08C8 0008; 
5103 BFE2 8673 9673; 
9F30 2903 BFE2 96B3; 
303B 0343 80F8 08BO; 
021F 0100 OlFO 0104; 
0104 0582 0103 0103; 
0205 0303 0279 0318; 
03CB 0387 0398 039B; 
01B6 0267 0348 034B; 
024E 0244 0241 0103; 
F81C 8848 B248 8248; 
F08F FBFF 52F3 E0C6; 
2208 E0F8 2380 8273; 
1238 E3F6 C8FF OOFS; 
B7F8 2884 F83C: 85F8; 
8B97 5B1B 5007 168B; 
0073 0722 B24D 8207; 
07 IE B94D 89E2 49FF; 
fCBO 86F8 2022 2273; 
F0B6 D5FF 1 03B 6886; 
997C 0038 7373 86F6; 
3042 FC08 F807 B649; 
0237 07 IE 86F4 8996; 
0718 8DE2 F486 9DB6; 
86FF 2086 967F 0038; 
20 IB OBFF 2032 89FF; 
C54D 8098 5010 8850; 
B8D7 1820 FCOl 5080; 
0032 2030 8004 0188; 
1B9F FE04 0259 3020 ; 
0402 544B F80F 8897; 
8898 2074 BR2F 8F38; 
88C3 OlFB COOl 209B; 
49F3 3223 FB80 32 IC; 
2482 F520 9275 337F; 
5504 0525 3055 0401 ; 
9852 0719 F733 7FF8; 
01C9 8040 B840 3055? 
F44E FBOO 3870 2907; 
02F4 07 IE 89F7 8899; 
89F8 B089 93B9 0402; 
15F8 0704 0009 0402; 
4082 COOl 2820 4154; 
3BC2 3!0F2 0719 F880; 
3366 0715 88F8 0004; 
2897 C7F8 FF30 0F73; 
FC81 FC80 3B66 509F; 
0888 8832 97F8 2004; 
0718 8004 0413 3B25; 
F808 0402 5510 04031 
EOFl 2020 382E 1202; 
072E 389B FB08 385E; 
2E8B 739B 5005 072E; 
BB88 RE05 0401 C598; 
8F04 01C5 1288 F788; 
88F 1 328F 8FF6' 388F; 
0404 OE04 01C5 EDIO; 
01C5 F810 8F40 B800; 
0404 223B C5E0 1088; 
38B1 0504 01C5 9852; 
0404 1320 2004 04131 
118F E088 F752 2098; 
lOFO 7E73 F07E 7388; 


2 K 
TINY 
BASIC 


Cold start $P1 
Warm start $P3 
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04 0 0 

7ED4 

04£4 

£F8F 

CR03 

ERIE 

OEFE 

04 io 

RD30 

18ED'1F0FE 

3B£1 

1D97 

F773 

04c* 0 

00 ns 

8RFE 

RR9R 

7EBR 

D5D7 

18C.E 

043 0 

0D3R 

£Eri4 

0598 

3£4B 

D4 0 0 

0C33 

044 0 

4DR9 

D717 

5DD5 

D71E 

B94D 

R9C 0 

0450 

BB4D 

RBD4 

0598 

3£4B 

D71C 

8973 

046 0 

D404 

FE3£ 

38D7 

£88R 

739R 

5D30 

0470 

4£BR 

0£RR 

D7£6 

8£73 

9E73 

D405 

0480 

88D4 

048B 

4£B9 

0£R9 

cool 

EDD7 

0490 

FCO£ 

F3£D 

3R9C 

9£7G 

OOF 3 

3E4B 

04 RO 

3897 

FED? 

1R97 

765D 

30BE 

F830 

04 B 0 

9riBE 

D4 0 0 

06FR 

7F3£ 

E£5£ 

FB7F 

04C 0 

3£9E 

FBI 9 

3£R1 

D713 

0£F3 

3ED7 

04110 

riri£B 

8BFF 

3033 

BEFS 

3 ORB 

F80D 

04E 0 

198B 

F73B 

ECF8 

07D4 

0EF4 

0B38 

04F0 

B£D4 

0£ri5 

D718 

8B5D 

F830 

RECO 

05 0 Hi 

C58R 

5£9R 

F1C£ 

0£7F 

D7£0 

BB4D 

05 1 0 

C68D 

nSED 

8RF5 

5£9R 

£D75 

EEFl 

05 c' 0 

0ri3R 

1E3 0 

0DD4 

05£8 

D4 01 

C:54D 

053 0 

E64D 

R68ri 

5£D7 

190£ 

5DRD 

8RD5 

054 0 

9B5ri 

11404 

FED? 

£R8B 

739B 

73D4 

055 0 

ri7£R 

8BF7 

£D9B 

f r' oo 

7B4B 

BR4B 

056 0 

3£7B 

0403 

15F8 

EDFE 

0DD4 

0£F4 

057 0 

7B4B 

FEOD 

3R67 

D40£ 

D53 0 

50D7 

0580 

ri5D7 

£68£ 

739£ 

5DD7 

18ED 

CED7 

059 0 

1£E£ 

738R 

73C 0 

OlED 

D7E7 

4B5D 

05 RO 

inns 

D403 

5ED4 

04FE 

FCFF 

97RF 

05 E 0 

8BRD 

£F£F 

£F4D 

FBOD 

3RB4 

£B£E 

05 C 0 

£8 OB 

FEOD 

735D 

3£D9 

9R5D 

1D8R 

05EI0 

RRIF 

IFIF 

4RFB 

0D3R 

D3D7 

EEBiR 

05E0 

8RF7 

RRc’D 

9R77 

EiRlD 

8FF4 

BF8F 

05 FO 

FF£D 

74E£ 

73B8 

9F73 

5£8£ 

F598 

06 0 0 

0£7E 

8F3£ 

305£ 

FE3B 

1ED7 

EEEF 

061 0 

R89F 

7C 0 0 

E848 

5F1F 

1R9R 

3R15 

06c* 0 

98BF 

D7£4 

B84D 

R8£R 

EF08 

OOTO 
C O 1 o 

0630 

D7£4 

1 £4£ 

73 0£ 

5DD7 

EEER 

4DRR 

064 0 

3£4E 

8F5R 

1R4D 

5R1R 

4B5R 

FBOD 

0650 

B573 

5£97 

BRED 

43D5 

5DED 

88FR 

066 0 

FR08 

CEC4 

1£DD 

FCOO 

376E 

FFOO 

0670 

11811 

73C0 

8140 

D71£ 

3£7E 

DC 17 

068 0 

R4£4 

3R9 1 

£710 

E159 

C3ER 

56£C 

069 0 

CF30 

DO 10 

llEE 

6C8C 

474F 

5355 

06R0 

llEO 

1416 

8B4C 

45D4 

R080 

BD30 

06 B 0 

8C50 

D£83 

494E 

D4E1 

•6E85 

BR38 

06C 0 

R££l 

6330 

DOEO 

83RC 

££6£ 

84EB 

06 DO 

riE£4 

93E0 

£31D 

9149 

C630 

D031 

06E0 

5448 

45CE 

ICID 

38 OB 

9B49 

CE83 

06F0 

1 0E7 

£43F 

£091 

£7E1 

5981 

RC30 

0700 

RC4D 

EOID 

8R5£ 

45D4 

8355 

5ECE 

0710 

454E 

C:4E0 

£DS7 

5£55 

CEIO 

1138 

0720 

ri7£B 

9F4C 

4953 

D4E7 

OR 00 

01 OR 

0730 

D030 

CBEO 

£400 

0000 

0000 

OOOR 

0740 

£3111 

845£ 

45CD 

IDRO 

80BD 

38ER 

0750 

£F85 

RD30 

E617 

6481 

RB30 

E685 

0760 

5R93 

RD30 

E619 

5430 

F585 

RR30 

0770 

RF30 

F51B 

54£F 

885£ 

4E44 

R831 

0780 

5553 

5£R8 

30D0 

30CB 

30CB 

311C 

0790 

£FC1 

£F80 

R865 

30D0 

0B30 

RC30 

07R0 

84BD 

09 0£ 

£F83 

3CBE 

7485 

3CBD 

07B0 

BC09 

OlEF 

853E 

BD09 

06£F 

853E 

07C0 

80BE 

0904 

£F19 

170R 

0001 

1809 

07D0 

OR 09 

£91R 

ORIR 

8518 

0813 

0980 

07E0 

316R 

3175 

IBIR 

1931 

7518 

EFOB 

07F0 

OBOl 

0701 

06£F 

OB 09 

060R 

0000 
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3Bei I171H5 
977? 5DFF! 
i:i£Bl 4BFBJ 
46D7 1CB9; 

0£7F D7£0j 
995D 304£5 
4BD4 048B5 
013fl 653 O; 

££ 1 £ 1 £ 8 £; 
l£ri5 D716; 
fiBB4 0£54; 

3£B£ FB75; 

£11 0£ F33R; ' 

3Si;i£ 5BD7; 

4BFB GDSft; 

dies 11401 ; 

fiBri4 0598; 

33 1£ 4BFB; 

B84D 88411; 

D7£u 8B73; 

04FE £E£B; 

FlR3Fl 6£9R; 

11400 0C33; 

£i;:BB 4DRE; 

£8RR 4D1£; 

1D4E 73Fi; 

33 BR 9BBri; 

11403 5Eri7; 

5D9E BR8E; 

4riRR ri7£4; 

FR80 CEFS; 

5£9£ 75i::3; 

4DRF E£F7; 

3030 9frf; 

1R9R 3R£9; 
ri7£8 RFFi; 

3R47 C00£; 

0FF9 605D; 

3F6C D5D7; 

£11511 cosi; 

8R47 4F54; 

C;£30 DOlO; 

DOEO i3iri; 

5338 5583; 

El 67 4R83; 

1F30 11084; • 

5055 D4R0; 

D013 118£; 

E015 11185; 

0R84 4E45; 

7FFF 653 O; 

8 OIF £493; 

8£RC 6£0B; 

RB30 E618; 

F51fi 5R85; 

1539 448E; 

£E£F R£l£; 

D080 R9£F; 

0903 £F84; 

BC09 05£F5 
8009 801£» 

1£03 010£; 

0105 01045 
1C17 £F00 
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APPENDIX B 

REGISTER ALLOCATIONS 

Registers RO and R1 are not used by TINY BASIC In any way. In addition r 
the program makes no reference to Q or EF1,2,3 or 4. All character I/O is 
funnelled through a vector near the bc»ginning of the program. The user may 
request the performance of INP or OUT instructions as part of the BASIC prpgram, 
but these are up to the user's discretion. 


The other registers used by TINY are as follows: 


2 

3 

4 

5 

6 

7 

8 
9 
A 

B 

C 

D 

E 

F 


Control stack pointer. 

Inner interpreter Program Counter. 

Call linkage PC. 

Return linkage PC. 

Top of control stack; ^address of caller. Also holds branch address. 
Byte Fetch PC. 

Ten^rary work register. Receives second argument in USR call. 

Outer inteirpreter Program Counter. »address of next IL opcode. 

16-bit accumulator and work register. Contains third argument 
of USR calls, and part of response from USR calls. 

BASIC Pointer. Points to next token. 

Timing subroutine in Terminal I/O. 

Workspace memory pointer. ^Expression Stack Pointer in USR calls. 
Subroutine linkage temporary and Terminal timing constant. 

Temporary work register. 


Machine lainguage subroutines called via the USR function have the free use of 
R0,R1,R8,RA,RD,RF. 
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APPENDIX C 


USE OF FIRST PAGE OF USER RAM BY TINY BASIC 


0812 

0813 

0814 

0815 

0816 

0817 

0818 
0819 
081A 
081B 

081C-081D 

081E-081F 

0820-0821 

0822-0823 

0824-0825 

0826-0827 

0828-0829 

082A-082D 

082E-082F 

0830-087F 

0880-0881 

0882-08B5 


0T3/UT4 output delay flag 

Copy of BACKSPACE code 

Copy of CANCEL code 

Copy of Pad code 

Copy of Tape Mode En 2 dDle 

Copy of Spare stack Space 

Execution mode flag 

End of input line 

Expression Stack pointer 

Output Control 

Saved address for NX 

Copy of IL base address 

Lowest address of user program space 

Highest address of user program space 

End of user program + stack reserve 

Top of GOSUB stack 

Current Line number in BASIC 

Temporary 

Input line pointer 

Input line buffer and expression computation stack 
Random Number Generator seed 
BASIC variables A-Z 


Note; 


Each variable occupies two bytes beginning at a displacement in the 
page which is twice its ASCII code. 

Displacement Variable 


0082 A 

0084 B 


00*B4 Z 
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APPENDIX D 

ALLOCATIONS IN LOW RAM 


0001 

Cold Start 

0003 

W2unn Steurt 

0006-0008 

LBR to character Input 

0009-000B 

LBR to character output 

OOOC-OOOE 

LBR to Break test 

OOOF 

Backspace code 

0010 

Line Cancel code 

0011 

Pad character 

0012 

Tape Mode eneOale flag (hex 80=enabled) 

0013 

Space stack size 

0014 

Byte fetch subroutine 

0016 

Double byte fetch entry vector 

0018 

Byte store Subroutine 

OOIA-OOIB 

Address of IL 

OOlC-OOlD 

User space start for scan 

OOIE 

Page for memory wrap test 

OOlF 

Page for workspace 

0120 

Entry vector for Hex input 

0123 

Entry vector for Hex print 

0126 

Entry vector for I/O 

0129 

Entry vector for AND 

0800 

Beginning of user RAM space 
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JgPENDIX E 

ERROR MESSAGE SUMMARY 

0 Break during execution 

8 Memory overflow; line not inserted 

9 Line number 0 not allowed 

II RUN with no progreun in memory 

33 Improper syntax in GOTO 

35 NO line to GO TO 

40 LET is missing a varieible name 

42 LET is missing an » 

45 In^roper synt£oc in LET 

47 LET is not followed by END 

65 Missing close quote in PRINT string 

83 Circumflex in PRINT is not at end of statement 

85 PRINT not followed by END 

101 IF not followed by END 

III INPUT syntax bad - expects variable name 

130 INPUT syntax bad - expects comma 

131 INPUT not followed by END 

140 RETURN s^tax bad 

141 RETURN has no matching GOSUB 

142 GOSUB not followed by END 

147 END syntax bad 

179 LIST synteoc error - expects comma 
189 Can't LIST line nvnnber 0 

193 LIST not followed by END 

198 REM not followed by END 

199 Missing statement type keyword 

201 Misspelled statement type keyword 

243 Divide by zero 

276 Syntax error in Expression - expects value 

281 RND expects two argtiments 

286 Missing right parenthesis 

321 IF expects relation operator 

356 Invalid arguments in RND 

All other error ninnbers signify memory overflow (too many nested GOSUBS) 
or an excessively complex expression. 10 _?q 
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ItfPENDIX F 

SPECIAL KEYBOARD CONTROL CHARACTERS 

You may erase (backspace over) an incorrectly-entered character by hitting, 
the "erase previous character" key. Its hex code is stored in location OOOF, 
and it is presently an ASCII Left-arrow or Underline (Shift 0; hex 5F) . Each 
occurrence of erases the last stored input character. Thus, 

POINT PINT 

corrects the erroneous second character. Similarly, you may erase the entire input 
line and start over by hitting the "ceuicel line" character. Its hex code is 
stored in location 0010, and it is presently an ASCII CANCEL (Control X; hex 18) . 

You may change either of these edit control characters by changing its stored code - 
to any value except DC3, LF^ NULL or DELETE (hex codes 13, OA, 00 and .FF, 
respectively) . These special characters are trapped by TINY before its line edit 
code is entered. 

The BREAK key may be used for two purposes: to interrupt a long LISTing or 
to interrupt the execution of a program (for example, one caught in an endless 
loop). While executing the LIST command, TINY checks BREAK at the beginning of 
every typed line. While executing a stored progr£un, TINY checks BREAK between 
statements. 

Each of your input lines from the keyboard is terminated with a carriage return 
(CR) . Whenever TINY generates a new line (for exar^le, when it echoes your CR) , 
it generates CR PAD PAD LF PAD, where the pad character depends on the 2^ bit 
of location 0011 (hex). If 0, it is the NULL character (hex 00). If 1, it is 
the RUBOUT/DELETE character (hex FF) * The rest of the byte in location 0011 
defines the count of the number of pads to be sent between each CR and LF. It is 
presently set to 2. 


SUMMARY OF KEY CHARACTERS 

CR Terminates every entry line. 

Backspace. 

CAN Camcel line. 

BREAK Interrupt long printout or execution. 
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Appendix G 

Tape Control Characters 


Whenever TINY generates the 7 prompt chauracter (during execution of 
an INPUT statement ) , It follows this by generating the XON (ASCII DCl) control 
character. If the. Input comes from tape, the user may elect to use this 
special control chauracter to activate the tape reader. 

Similarly, TINY generates the XOFF (ASCII DC3; hex 13; Control S) control 
character whenever am error stop or NEW or END occurs - vmder the assumption 
that the user may want to deactivate the reader with this character. 

These control chauracters may be Ignored if the user has found an 
alternative method for tape I/O. 
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